Release 10.1A: OpenEdge Development:
ADM and SmartObjects

SmartToolbar instance properties

Figure 2–12 shows the SmartToolbar instance properties dialog box:

Figure 2–12: SmartToolbar Properties dialog box

The instance properties in this dialog box are grouped into two panes containing, Style and Content. Figure 2–12 shows the default properties; the available properties might change if you add or remove actions from the SmartToolbar or the action class (on which the SmartToolbar is based). You use these instance properties as described in the following sections.

Style pane

You use the instance properties in the Style pane to specify how your SmartToolbar instance provides access to toolbar actions. You can specify a menu bar, a toolbar, or a menu bar and a toolbar. You cannot deselect both the menu bar and the toolbar. The Style pane contains the following items:

Menu — If checked (the default), this specifies that the SmartToolbar instance provides a menu bar with the two menus (File and Navigation) shown in Figure 2–13.



Figure 2–13: SmartToolbar menus

Figure 2–13 shows how the menus look when all possible commands are enabled. Various commands are present or absent from the menu bar depending on how you set the instance properties in the Contents pane at design time.

Toolbar — If checked (the default), this specifies that the SmartToolbar instance provides a toolbar, shown in Figure 2–14.



Figure 2–14: SmartToolbar toolbar

Figure 2–14 shows how the toolbar looks when all possible icons are displayed. Various icons are present or absent depending on how you set the instance properties in the Contents pane at design time.

Show Border — If checked, this adds a graphic border that surrounds the toolbar and divides the icon groups. This property is enabled only if the Toolbar property is checked.

Contents pane

You use the instance properties in the Contents pane to specify the actions that application users can perform from the SmartToolbar. Each property represents several actions (as defined defined by the action class):

Navigation — If checked (the default), enables navigation actions: first record, previous record, next record, and last record. These actions are accessible from the First, Prev, Next, and Last commands on the Navigation menu and from the third group of icons (the arrow icons) on the toolbar.
Tableio — If checked (the default), enables TableIO actions: add, update, copy, delete, and save records; reset; and cancel. These actions are accessible from the Add record, Update record, Copy record, Delete record, Save record, Reset, and Cancel commands on the File menu and the first group of icons on the toolbar.

The Save and Update radio buttons associated with the Tableio check box enable slightly different sets of TableIO actions:

Clicking the Update button includes the File menu’s Update record and the corresponding icon on the toolbar.
Clicking the Save button omits the Update record command and icon.
Commit — If checked, this enables commit actions for updateable objects: undo and commit. These actions are accessible from the File Undo and File Commit commands and from the second group of icons on the toolbar. The default is unchecked.
Note: This property is enabled only if you link the SmartToolbar as a Commit-Source to a Commit-Target.
Filter — If checked, this enables calling a SmartFilter that is the SmartToolbar’s Navigation-Target. This functionality is available through the File Filter command and the last icon on the toolbar. For details, see the "Filter link as pass-through link" section.